Configure the integration with CENTURY to enable the creation of accounts for staff and learners in CENTURY and then retrieve a learner's initial assessments from CENTURY.
Before configuring the integration with CENTURY note the following prerequisites:
- ebs
- You must have the following:
-
- An ebs account with administrative permissions for ebs: central and ebs: ontrack Hub.
- The institution must have the Century Connector licence to integrate ebs with CENTURY.
- CENTURY
- You must have an account with access to the following details:
-
- Organisation ID, such as 76f16e45-802b-4d3a-aa1c-effe393f16c2.
- API URL, such as https://connect.century.tech/api/v1.
- API key identifier, such as hslc2vq9wa.
- API key, such as 8102f70c-029b-48a3-8370-89c05eaa0ee6.
If you want to add learners to cohorts and classes in CENTURY you must also have the GUIDs for the CENTURY cohorts and classes that the learners will be added to.
Set up the integration with CENTURY as follows:
Create a user account
Create the ebs user account used to create the Learner Attainments retrieved from CENTURY as follows:
-
On ebs: central, create the new user account. For example, centuryintegration.
-
Grant the user account the Full attainments role.
-
Make a note of the username and password.
Optionally, add cohorts and classes reference data
To enable staff members to add learners or staff accounts to CENTURY cohorts or classes in ebs: ontrack Hub, you must define the options available on the screen in the reference data for CENTURY Cohorts and CENTURY Classes.
Add the required details to the reference data for CENTURY cohorts and classes as follows:
-
On ebs: central, go to System > Reference Data and then search for
CENTURY. -
Define the required reference data for CENTURY Cohorts and CENTURY Classes.
For example, the tables below show a Hesslewood College 24/25 cohort and English and Maths Key Skills classes.
- CENTURY Cohorts
-
Code Short Description Long Description Active c81fd38c-03f6-4b68-8720-84a7233e89de 24/25 Hesslewood College 24/25 Cohort Yes -
CENTURY Classes
-
Code Short Description Long Description Active c8a55fda-7144-336f-a4f5-0f47ddbf15be ENG English Key Skills Yes c5a77fda-7174-446f-a4f5-0f47ccbf15ce MAT Maths Key Skills Yes
The long descriptions are shown in ebs: ontrack Hub.
BETA Add course and register events details
For courses and register event details that you want to sync to CENTURY you must define the following details:
-
Define CENTURY details for courses. On Ontrack Staff Hub, go to Course > CENTURY Details and define the following details:
- Type of CENTURY entity to be created, such as Class.
- Academic Year for the course. Note that this is restricted to active academic years and defaults to the year that overlaps the course dates.
-
Name and Description defaults to the descriptions of the Course and Course Code, or the calendar occurrence if the description has not been populated.
-
Tutor Group shows tutor groups linked to the selected course occurrence.
-
Active defines whether the record is active.
-
Define CENTURY details for register events. On Ontrack Staff Hub, go to Register > CENTURY Details and define the following details:
- Type of CENTURY entity to be created, such as Class.
- Academic Year for the course. Note that this is restricted to active academic years and defaults to the year that overlaps the course dates.
-
Name and Description defaults to the descriptions of the Course and Course Code, or the calendar occurrence if the description has not been populated.
-
Active defines whether the record is active.
Add institution settings
Add the required institution settings for the CENTURY integration as follows:
-
On ebs: central, go to System > Institution Settings and then select CENTURY.
-
Define the required reference data for Century as shown in the table below.
This field Holds this information... CENTURY Organisation ID The institution's CENTURY organisation ID, such as 76f16e45-802b-4d3a-aa1c-effe393f16c2. CENTURY API URL The CENTURY API URL, such as https://connect.century.tech/api/v1. CENTURY API Key ID The institution's CENTURY API key identifier, such as hslc2vq9wa. CENTURY API Key The institution's CENTURY API key, such as 8102f70c-029b-48a3-8370-89c05eaa0ee6. CENTURY ebs User The username of the ebs account. For example, centuryintegration. CENTURY ebs Password The password for the ebs account. For example, cXmnZK65rf*&DaaD. CENTURY Email Address for Error Messages The email address where any errors that occur when creating CENTURY accounts in ebs: ontrack Hub are sent. For example, centuryadmin@hesslewoodcollege.ac.uk. CENTURY Default Cohort The, optional, default cohort that learners will be selected when creating a CENTURY account in ebs: ontrack Hub. For example, Hesslewood College 24/25 Cohort. CENTURY Default User Password The default password for CENTURY learner and staff accounts created in ebs: ontrack Hub. BETA CENTURY Learner Matching View The Data Miner view that is used to match on CENTURY information. Note that you can change this to a user defined view if the institution matching criteria is non-standard. BETA CENTURY Bulk Initial Assessment Load from Date The date from which ebs will retrieve completed IA results. The default setting is 01/08/2024. Subsequent workflow runs will update this setting to the current date. BETA CENTURY Academic Year Only consider the selected year equal or greater for syncing to CENTURY. BETA CENTURY Course Membership View The Data Miner view used to retrieve students and teachers from Curriculum items to sync to CENTURY Classes. BETA CENTURY Register Membership View The Data Miner view used to retrieve students and teachers from Register Event items to sync to CENTURY Classes. -
Set the Initial Assessment Attainment Type. On Institution Settings, go to General (Cross-System) and then set the Initial assessment attainment type to Initial Assessment.
-
Set the default domain to use in creation of email addresses. On Institution Settings, go to General (Cross-System) and then set the Default domain to use in creation of email addresses to the institutions domain. For example, hesslewoodcollege.ac.uk.
Test the integration
Test the integration with CENTURY as follows:
-
On ebs: ontrack Hub, go to Learner or Staff and then Search for a learner or staff member.
-
On the selected learner or staff member, go to Century in the Learner or Staff links menu. Then, go to Sync > Activity, and then select Create a CENTURY Account.
-
Optionally, select a Cohort and Class.
-
Submit the CENTURY Account creation request. Then, refresh the page, if the request was successful Has CENTURY Account updates to Yes, as shown in the image below. Note that the workflow may not run instantly if the workflow server is busy.
Any errors are sent to the email address of the staff member creating the CENTURY account in ebs: ontrack Hub and the email address defined in Add institution settings.